﻿@page "/es/5.8/modules/plg-elastic-report"
@{
    Layout = "_ArticleLayout";
    ViewBag.Title = "Elastic Report Plugin";
}

@section Styles {
    <link href="~/lib/prismjs/prism.css" rel="stylesheet" />
}

@section Scripts {
    <script src="~/lib/prismjs/prism.js"></script>
}

<nav class="doc-toc">
    <div class="h6">En esta página</div>
    <hr>
    <ul>
        <li><a href="#overview">Introducción</a></li>
        <li><a href="#installation">Instalación</a></li>
        <li>
            <a href="#configuring">Configuración de informes</a>
            <ul>
                <li><a href="#configuration-file">Archivo de Configuración de Informes</a></li>
                <li><a href="#report-styling">Estilos de Informes</a></li>
                <li><a href="#add-report">Añadir informes a la Configuración de la Base de Datos</a></li>
            </ul>
        </li>
    </ul>
</nav>

<div class="doc-content">
    <h1>Elastic Report Plugin</h1>

    <h2 id="overview">Introducción</h2>

    <p>Elastic Report Plugin permite generar informes de acuerdo con una configuración personalizada. Con este complemento se puede crear casi que cualquier informe deseado. Un usuario simplemente selecciona el período y hace clic en el botón generar informe. Un administrador crea configuraciones de informes que definen un conjunto de diferentes secciones de informe y unen las columnas y filas del informe a los datos del sistema.</p>

    <h2 id="installation">Instalación</h2>

    <p>Primero debe realizar <a href="../installation-and-run/module-installation#plugins">la secuencia general de instalación de complementos</a> y luego realizar varias acciones adicionales:</p>

    <ol>
        <li>Vaya al <em>Main Menu &gt; Registration &gt; Elastic Report</em>.</li>
        <li>Registre el complemento utilizando los hipervínculos en la página.</li>
        <li>Agregue la clave de registración al proyecto bajando la configuración de Webstation, utilizando para ello la aplicación Administrator.</li>
    </ol>

    <h2 id="configuring">Configuración de informes</h2>

    <p>Un informe consta de un conjunto de secciones que aparecen, una por una, en el documento de salida. Cada sección tiene su propio tipo, parámetros y enlace de datos. Además, el informe tiene parámetros generales que afectan a todas las secciones. El mismo informe se puede generar en una variedad de formatos. Actualmente soporta los formatos Excel, PDF y HTML. La apariencia de un mismo informe, generado en diferentes formatos,  puede diferir ligeramente.</p>

    <h3 id="configuration-file">Archivo de Configuración de Informes</h3>

    <p>El archivo de configuración especifica el formato del informe y define el enlace de los datos a los canales de entrada. Debe haber un archivo de configuración separado para cada formulario de informe. El archivo de configuración está en formato XML. Debe guardarse en el directorio <em>Interface</em>, o en su subdirectorio dentro de un proyecto.</p>

    <p>El plugin distributivo contiene un ejemplo del archivo de configuración de informe, SCADA\Interface\ElasticReport\ElasticRepExample.xml. Este ejemplo incluye la descripción detallada de la configuración y demuestra la generación de secciones de informe, de todos los tipos posibles.</p>

    <p>Los archivos de configuración se pueden editar utilizando cualquier editor de texto. Por ejemplo, el editor de texto gratuito <a href="https://notepad-plus-plus.org/" target="_blank">Notepad++</a> permite trabajar comodamente con archivos XML mediante un complemento especial.</p>

    <h3 id="report-styling">Estilos de Informes</h3>

    <p>Es posible personalizar los estilos de informe: fuentes, colores, tamaños de celda, etc.</p>

    <p>El archivo SCADA\ScadaWeb\plugins\ElasticReport\templates\ElasticRepExcel.xml especifica los estilos de los informes en formato Excel.</p>

    <p>Para crear estilos personalizados, abra este archivo en Excel y vaya a la página <em>Custom Styles</em> donde se encuentran los estilos adicionales. Utilice los estilos de la página <em>Default Styles</em> como ejemplo.</p>

    <p>Los estilos personalizados para el formato PDF se especifican en el archivo SCADA\ScadaWeb\plugins\ElasticReport\template\ElasticRepPdfCustom.xml</p>

    <p>El archivo XML, que define los estilos de PDF, se edita manualmente utilizando cualquier editor de texto. Utilice los estilos predeterminados ubicados en ElasticRepPdfDefault.xml como ejemplo.</p>

    <p>Los estilos de informe para salida HTML se configuran en el archivo SCADA\ScadaWeb\plugins\ElasticReport\css\customstyles.css de acuerdo con las reglas de Cascade Style Sheets.</p>

    <h3 id="add-report">Añadir informes a la Configuración de la Base de Datos</h3>

    <p>Para hacer que el informe aparezca en la lista de informes disponibles, es necesario registrarlo en la tabla <em>Interface</em> utilizando la aplicación Administrator. Especifique la ruta al archivo de configuración del informe relacionado con el directorio de la interfaz, especifique el tipo de informe ElasticRep e ingrese el título del informe (ver la Figura).Después de subir el proyecto al Server, el informe está disponible en la página <em>Main Menu &gt; Reports</em> page.</p>

    <figure class="figure">
        <img src="plg-elastic-report-files/report_itf_file_en.png" class="figure-img img-fluid" alt="Archivo de informe" />
    </figure>

    <figure class="figure">
        <img src="plg-elastic-report-files/report_itf_tbl_en.png" class="figure-img img-fluid" alt="Edición de la tabla de interfaz" />
    </figure>
</div>
